home *** CD-ROM | disk | FTP | other *** search
/ Atari Mega Archive 1 / Atari Mega Archive - Volume 1.iso / apps / astronmy / sat404.lzh / README.DOC < prev    next >
Text File  |  1992-01-02  |  42KB  |  991 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.  
  9.  
  10.  
  11.  
  12.  
  13.  
  14.  
  15.  
  16.  
  17.  
  18.  
  19.  
  20.  
  21.  
  22.                      Satellite Orbital Prediction Program
  23.                    Copyright (c) 1991 by Bill Penner, WB7DPF
  24.  
  25.  
  26.  
  27.  
  28.  
  29.  
  30.                                  Version 4.03
  31.                                22 December 1991
  32.  
  33.  
  34.  
  35.  
  36.  
  37.  
  38.  
  39.  
  40.  
  41.  
  42.  
  43.  
  44.  
  45.  
  46.  
  47.  
  48.  
  49.  
  50.  
  51.  
  52.  
  53.  
  54.  
  55.  
  56.  
  57.  
  58.  
  59.  
  60.  
  61.  
  62.  
  63.  
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70.  
  71.  
  72.  
  73.  
  74.  
  75.  
  76.     INTRODUCTION
  77.  
  78.          This  program  was written to be used to predict the position of a
  79.     satellite  using  either  standard  Keplerian  orbital  elements  or  a
  80.     position  and  velocity  vector,  such  as the NASA M50 elements.  This
  81.     program  was  based  on  the orbital predication calculations found the
  82.     orbit  prediction  program  written  by  Dr.  Thomas  A.  Clark, W3IWI,
  83.     however,  since  version  3.11  I have rewritten everything to slightly
  84.     improve  accuracy,  and to provide more information.  I originally took
  85.     the  Apple  version  by Dr. W. D. McCaa, K0RZ, rewrote it for the ATARI
  86.     800XL,  adding a real time component, and then rewrote it for the ATARI
  87.     ST.  This program is written in Megamax Laser C.
  88.  
  89.          The  program  can be ran as either an application (normal program)
  90.     or  an  accessory.   This program will run from either a floppy or hard
  91.     disk and will work on the ST, STE, MSTE, and the TT computers.
  92.  
  93.     SETTING UP THE FILES
  94.  
  95.          To  run  the  program  as  a  program,  copy  all  data files to a
  96.     directory  or subdirectory.  The program does not need to be located in
  97.     the  same  directory  as  the  data files and can be located in another
  98.     directory.   I  recommend  that during initial use of the programs, the
  99.     data  files  and  the program should be located in the same directory.
  100.     The  default  configuration  expects  the  data  file to be in the same
  101.     directory.   If  you wish to locate the data files separately, read the
  102.     section discussing configuration editing.
  103.  
  104.          If  you  wish  to  run  the  program  as  an accessory, rename the
  105.     SAT403.PRG file to SAT403.ACC, and place the program on your root drive
  106.     (usually C: on hard drives or A: if you boot from floppy).  For easiest
  107.     use,  place  the data files in the same directory as the accessory.  If
  108.     you  wish, you can place the data files in a subdirectory, however, you
  109.     will need to edit the program configuration.
  110.  
  111.  
  112.     STARTING THE PROGRAM
  113.  
  114.          To  run  the program as an application, double click on the file.
  115.     To  run  the program as an accessory, simply boot the computer with the
  116.     accessory in the boot (root) drive as setup above.
  117.  
  118.         When the program starts, if no configuration file (SATPRED.CNF) can
  119.     be  found  in  the  same  directory,  some  defaults  are assumed.  The
  120.     defaults   will   attempt  to  locate  a  satellite  data  file  called
  121.     BULLETIN.TXT  in  the  same  directory as the program or accessory, and
  122.     then  a  reference  location  data file called DEFAULT.SPL, also in the
  123.     same directory.
  124.  
  125.  
  126.     SETTING UP THE PROGRAM
  127.  
  128.  
  129.  
  130.  
  131.  
  132.  
  133.  
  134.  
  135.  
  136.  
  137.  
  138.  
  139.  
  140.          To set up the program, once it is running, you will need to set up
  141.     the  information  about what time zone you are in.  When the program is
  142.     run,  you  will  automatically  be  shown a dialog box to set the time,
  143.     whether  to ask for the time whenever the program is started, and if we
  144.     are  currently  in  daylight  savings.  To adjust for daylight savings,
  145.     click  on  the  daylight savings button (the box should become checked)
  146.     when  daylight  savings  is  in effect.  The button, simply adds 1 hour
  147.     (easterly time) to the time offset internally when it is set.  Next set
  148.     the  "Ask time at boot" button.  If you have a built in real time clock
  149.     or  some  other  program for setting the time, turn off the check mark,
  150.     else when the program is started up, it will ask for the local time and
  151.     offset.
  152.  
  153.          The  next  thing is to set up the location information.  This file
  154.     tells the program where to center the map, what location to use for the
  155.     reference  point  for  calculation  of  the  azimuth  (or bearing), the
  156.     satellite  elevation relative to the horizon and the difference between
  157.     the  computer clock time and UTC.  To edit the location data, place the
  158.     mouse on the [Location] button, press the left button and hold it down.
  159.     While holding the button, drag the mouse to the Edit Station menu entry
  160.     which  just  appeared  next to the Location button and then let go when
  161.     the  mouse is above the [Edit Location Info] entry.  You can also click
  162.     on  the [Location] button and then click on the Edit Station entry.  At
  163.     this  point,  a  dialog box will appear.  Fill in the location name (or
  164.     call  sign)  to  indicate  where  the  data  is  for,  the latitude and
  165.     longitude for your location (in decimal degrees, i.e. 122.456) and then
  166.     the  altitude  in either feet or meters.  You can configure the program
  167.     to  use either US or metric units by clicking on the units value shown.
  168.     Next,  set up the offset between UTC and local time.  This value should
  169.     be  set  to  8 for the Pacific time zone or 5 for Eastern time zone for
  170.     example  and  then the WEST button should be darkened to indicate which
  171.     direction  from  UTC.  When all of the parameters are correct, click on
  172.     the [Save] button
  173.  
  174.          If  everything started up ok, then you should be now able to click
  175.     on  the [Real Time Tracking] button and the first satellite in the data
  176.     file will be shown on the screen showing where the satellite is located
  177.     and some parameters associated with the satellite.
  178.  
  179.  
  180.     PROGRAM DETAILS
  181.  
  182.          The  main  intent  of  the  program  is  two fold.  The program is
  183.     intended  to generate real time data for use in locating a satellite at
  184.     a  specific  time  and to generate printed information over a specified
  185.     period  of  time.   The  program  also  provides utilities for loading,
  186.     merging,  editing, sorting, purging, and saving satellite orbital data.
  187.     Nearly  all  program functions can be accessed from the main menu.  The
  188.     uses of the main menu options are as follows.
  189.  
  190.     [Satellite]
  191.  
  192.          The [Satellite] button will bring up a pop-up menu.  On this menu,
  193.  
  194.  
  195.  
  196.  
  197.  
  198.  
  199.  
  200.  
  201.  
  202.  
  203.  
  204.  
  205.     the satellite database can be loaded, saved, merged, edited, or enabled
  206.     for processing.
  207.  
  208.          Satellite  data  can  be  saved in either ASCII or binary format.
  209.     When [Save Satellite] is selected, an alert box is displayed asking for
  210.     which  mode to save the file in.  ASCII format is to allow transferring
  211.     satellite  data  to  other  programs or computer types.  The ASCII file
  212.     data  is  in  the  standard  NASA  2 Line format.  The binary format is
  213.     included mainly for speed.  The ASCII file does take some time to load,
  214.     whereas  the  binary  format  can load nearly as fast as the screen can
  215.     redraw.   When [Load Satellite] is selected, the file mode is not asked
  216.     as  the program will automatically determine if the file is an ASCII or
  217.     binary file.
  218.  
  219.          The  [Edit  Satellites]  option  is  where  the  satellite orbital
  220.     parameters  may  be entered or edited.  The time data can be entered in
  221.     either of two formats; year and decimal day, or MM/DD/YY HH:MM:SS.SSSS.
  222.     Either  the  use  of  semi-major  axis (SMA) or mean motion (MM) may be
  223.     selected.   This  option  is  changed  by clicking on the [MM] or [SMA]
  224.     button and selecting the desired mode on the pop-up menu.  The units of
  225.     SMA  can  also  be  changed  between meters and feet by clicking on the
  226.     [meters]  or  [feet]  button and then select the desired units from the
  227.     pop-up menu.  The option of entering a position and velocity vector can
  228.     be accomodated by clicking on the [Enter M-50 Parameters] button.  This
  229.     will  bring  up  a  dialog  box  for  the  entry of these values.  When
  230.     [Convert]   is  clicked,  the  orbital  values  of  Inclination,  RAAN,
  231.     Eccentricity,  Arg  of  Perigee, Mean Anomal